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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3' Generation Partnership Project (3GPP). 

The present document is part 3 of a muhi-part TS covering the 3"* Generation Partnership Project: Technical 
Specification Group Services and System Aspects; Telecommunication Management; Configuration Management, as 
identified below: 

Part 1: "3G Configuration Management: Concept and Requirements"; 

Part 2: "Notification Integration Reference Point: Information Service Version 1"; 

Part 3: "Notification Integration Reference Point: CORBA Solution Set Version 1:1"; 

Part 4: "Notification Integration Reference Point: CMIP Solution Set Version 1:1"; 

Part 5: "Basic Configuration Management IRP Information Model (including NRM) Version 1"; 

Part 6: "Basic Configuration Management IRP CORBA Solution Set Version 1:1"; 

Part 7: "Basic Configuration Management IRP CMIP Solution Set Version 1:1"; 

Part 8: "Name Convention for Managed Objects". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are 
initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface for CM is built up by a number of Integration Reference Points (IRPs) and a related Name 
Convention, which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
ITU-T Recommendation X.736 [1] and OMG TC Document telecom [2]. For CM, a number of IRPs (and the Name 
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Convention) are defined herein, used by this as well as other specifications for Telecom Management (TM) produced 
by 3GPP. All these are included in 3GPP TS 32.106 from Part 2 and onwards. 

The present document is Part 3 of 3GPP TS 32.106 (3GPP TS 32.106-3) - Notification IRP CORBA Solution Set. 

IRP Solution Set version: The version of this CORBA Solution Set is 1:1, where the first "1" means that it 
corresponds to the Information Service (3GPP TS 32.106-2 [5]) version 1, and the second "1" means that it is the first 
CORBA Solution Set corresponding to this Information Service version. 
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1 Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service (3GPP TS 32.106-2 [5]). 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ITU-T Recommendation X.736: "Security Alarm Reporting Function". 

[2] OMG TC Document telecom (98-11-01): "OMG Notification Service". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification.) 

[4] 3GPP TS 32. 106-8: "Name Convention for Managed Objects". 

[5] 3GPP TS 32.106-2: "Notification IRP: Information Service". 

[6] 3GPP TS 32.1 1 1-2: "Alarm IRP: Information Service". 

[7] 3GPP TS 32.111-3: "Alarm IRP: CORBA Solution Set, version 1:1". 

[8] ITU-T Recommendation X.733: "Alarm Reporting function". 

[9] 3GPP TS 32.101: "3G Telecom Management principles and high level requirements". 

[10] 3GPP TS 32.102: "3G Telecom Management architecture". 

[II] 3GPP TS 32.106-1: "3G Configuration Management: Concept and Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: Please refer to 3GPP TS 32.101 
[9], 3GPP TS 32.102 [10] and 3GPP TS 32.106-1 [1 1]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture (OMG) 

EC Event channel (OMG) 
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IDL Interface Definition Language (OMG) 

IS Information Service 

lOR Interoperable Object Reference 

NC Notification Channel (OMG) 

NE Network Element 

NV Name and Value pair 

EM Element Manager 

OMG Object Management Group 

QoS Quality of Service 

SS Solution Set 

UML Unified Modelling Language (OMG) 



4 Architectural features 

The overall architectural feature of Notification IRP is specified in 3GPP TS 32.106-2 [5]. This clause specifies 
features that are specific to the CORBA Solution Set (SS). 

4.1 Notification services 

In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]). 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality of Service (QoS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_events. The method takes as input a parameter of type EventBatch as defined in the OMG 
CosNotif ication module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRP Agent may push EventBatch with only one Structured Event. 

The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 
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module CosNotifyComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises { CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 



Mapping 



5.1 Operation mapping 



Notification IRP: IS (3GPP TS 32.106-2 [5]) defines semantics of operations visible across this IRP. 

Table 1 maps the operations defined in Notification IRP: IS (3GPP TS 32.106-2 [5]) to their equivalents (methods) in 
this Solution Set (SS). It also qualifies if a method is Mandatory (M) or Optional (O) 

Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 
3GPPTS 32.106-2 [5] 




Qualifier 


subscribe 


attach_push, attach_push_b, attach_pull 


M, 0, 


unsubscribe 


detach 


M 


get Notification 
IRPVersion 


get_notification_IRP_version 


M 


get Subscription 
Status 


get_subscription_status 


O 


get Sub script ion Ids 


get_subscription_ids 


o 


change Subscription 
Filter 


If subscription is established using attach_push method, the SS 
equivalent shall be change_subscription_f liter . The IDL 
specification of this method is included in Annex A. This method is 
Optional (O). 

If subscription is established using attach_push_b method, the SS 
equivalent shall be modif y_constraints. The method is defined in 
OMG Notification Service Filter Interface (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. If 
IRP Agent supports the optional attach_push_b method, it shall support 
this method as mandatory. 

If subscription is established using attach_pull method, the SS 
equivalent shall be modif y_constraints. The method is defined by 
OMG Notification Service Filter Interface (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. If 
IRP Agent supports the optional attach_pull method, it shall support 
this method as mandatory. 


See box on 
the left. 


suspend 
Subscription 


If subscription is established using attach_push, there is no SS 
equivalent. In other words, IRPManager cannot suspend subscription. 

If subscription is established using attach_push_b, the SS equivalent 
shall be suspend_connection . This method is defined by OMG 
Notification Service (OMG TC Document telecom [2]). The IDL 
specification of this method is not included in Annex A. If IRP Agent 
supports the optional attach_push_b method, it shall support this 
method as mandatory. 


See box on 
the left 
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If subscription is established using attach_pull, there is no SS 
equivalent. 




resume Subscription 


If subscription is established using attach_push, there is no SS 
equivalent. In other words, IRPManager cannot resume subscription. 

If subscription is established using attach_push_b, the SS equivalent 
shall be resume_connection . This method is defined by OMG 
Notification Service (OMG TC Document telecom [2]). The IDL 
specification of this method is not included in Annex A. If IRP Agent 
supports the optional attach_push_b method, it shall support this 
method as mandatory. 

If subscription is established using attach_pull, there is no SS 
equivalent. 


See box on 
the left 


get Notification 
Categories 


get_notification_categories 






5.2 Operation parameter mapping 

3GPP TS 32.106-2 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 
through table 12 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS subscribe parameters to SS attach_push equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif icationlRPConstDef s : : Notif icationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





sub script ion Id 


Return value of type 

Notif IcationlRPConstDef s : : Subscriptionid 


M 


status 


Attach, ParameterNotSupported, InvalidParameter, 

Already Sub scribed. 

At Leas tOneNotificationCategoryNot Supported 


M 


NOTE 1: IRPManager creates a CosNotifyComm: :SequencePushConsumer object and invokes 

CORBA: :ORB: : ob ject_to_string to obtain the stringifjed lOR, say s1. IRPManager stores tine s1. 
IRPManager sends s1 as input parameter of attach_push to IRPAgent. IRPAgent receives s1 , performs 
CORBA: :ORB: : string_to_ob ject to Obtain the IRPManager's lOR and uses it for its future methods. 
IRPAgent also stores the s1 for future comparisons. IRPManager later calls detach with s1 . IRPAgent 
receives the stringified lOR s1, compares it with those stored stringified lORs (e.g., s1), finds a match, and 
performs the detach process. IRPAgent pushes sequence of Structured Events towards IRPManager via the 
CosNotifyComm: : SequencePushConsumer object push_structured_events method, depending on 
the supplied notification categories and filter. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This grammar shall be the only one used for Alarm IRP: CORBA SS. 



Table 3: Mapping from IS subscribe parameters to SS attachjpush_b equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif icationlRPConstDef s : : Notif IcationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type 


M 
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Notif icationlRPConstDef s : : Subscriptionid 




Not specified in IS 


CosNotif yChannelAdmin : : SequenceProxyPushSupplier 
systein_ref erence (see NOTE 3) 


M 


status 


Attach, OperationNotSupported, 
ParameterNot Supported, InvalidParameter, 
Already Sub scribed. 
At Leas tOneNotificationCategoryNot Supported 


M 


NOTE 1: IRPManager creates a CosNotifyComm: :SequencePushConsumer object and invokes 

CORBA: :ORB: : ob ject_to_string to obtain the stringified lOR, say s1. IRPManager stores the s1. 
IRPIVIanager sends s1 as input parameter of attach_push_b to IRPAgent. IRPAgent receives s1 and stores 
the s1 for future comparisons. IRPIVIanager later calls detach with s1 . IRPAgent receives the stringified lOR 
s1 , compares it with those stored stringified lORs (e.g., s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OIVIG Notification Service (OMG TC Document 
telecom [2]). This grammar shall be the only one used for Alarm IRP: CORBA SS 

NOTE 3: IRPAgent provides this reference to which IRPIVIanager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 

interface CosNot if yChannelAdmin : : SequenceProxyPushSupplier and 
CosNotifyComm: : SequencePushConsumer. IRPManager is expected tO invoke 
connect_sequence_push_consumer method Of this interface tO Connect its OWn 
cosNotifyComm::sequencePushConsummer with this reference. After successful connection, IRPAgent 
pushes sequence of Structured Events towards IRPManager. 



Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerRef erence 


string manager_ref erence (see NOTE 1) 


M 


timeTick 


long time_tick 





notification 
Categories 


Notif icationlRPConstDef s : : Notif icationCategorySet 
notif ication_category_set 





filter 


string filter (see NOTE 2) 





subscriptionid 


Return value of type 

Notif icationlRPConstDef s : : Subscriptionid 


M 


Not specified in IS. 


CosNotif yChannelAdmin : : SequenceProxyPullSupplier 
system_ref erence (see NOTE 3) 


M 


status 


Attach, OperationNotSupported, 
ParameterNot Supported, InvalidParameter, 
Already Sub scribed. 
At Leas tOneNotificationCategoryNot Supported 


M 


NOTE 1 : IRPManager creates a CosNotifyComm: : SequencePullConsumer object and invokes 

CORBA: :ORB: : object_to_string to obtain the Stringified IOR,says1. IRPManager stores the s1. 
IRPManager sends s1 as input parameter of attach_pull to IRPAgent. IRPAgent receives s1 and stores the s1 
for future comparisons. IRPManager later calls detach with s1 . IRPAgent receives the stringified lOR s1 , 
compares it with those stored stringified lORs (e.g., s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This grammar shall be the only one used for Alarm IRP: CORBA SS. 

NOTE 3: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 
interface CosNotifyChannelAdmin::SequenceProxyPullSupplier and 
CosNotifyComm::SequencePullConsumer. IRPManager is expected to invoke 
connect_sequence_pull_consumer method of this interface to connect its own 

CosNotifyComm::SequencePullConsummer with this reference. After successful connection, IRPManager 
pulls sequence of Structured Events from IRPAgent. 
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Table 5: Mapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS lUlethod parameter 


Qualifier 


managerRef erence 


string manager_ref erence 


M 


subscriptionid 


Notif icationlRPConstDef s : : Subscriptionid 
subscription_id 





status 


Detach, InvalidParameter 


M 



Table 6: Mapping from IS getNotif icationiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS lUlethod parameter 


Qualifier 


versionNumber 
List 


Return value of type CommonlRPConstDef s : : VersionNumberSet 


M 


status 


GetNotif icationiRPVersion 


M 



Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


Notif icationlRPConstDef s : : Subscriptionid subscription_id 


M 


notification 
CategoryList 


Return value of type 

Notif icationlRPConstDef s : :Notif icationCategorySet 


M 


filterlnEffect 


string f ilter_in_ef f ect 





subscription 
State 


Not if icationlRPConstDef: : Subs criptionSt ate 
subs cription_st ate 





timeXick 


long time_tick 





status 


Getsubscriptionstatus, OperationNotSupported, InvalidParameter 


M 



Table 8: Mapping from IS getSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerRef erence 


string manager_ref erence 


M 


subscriptionldList 


Return value of type 

Notif icationlRPConstDef s : : SubscriptionldSet 


M 


status 


GetSubscriptionids, OperationNotSupported, InvalidParameter 


M 



Table 9: Mapping from IS changeSubscriptionFilter parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


Notif IcationlRPConstDef s : : Subscriptionid subscription_id 


M 


filter 


string filter 


M 


status 


ChangeSubscriptionFilter, OperationNotSupported, InvalidParameter 


M 
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Table 10: Mapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS IMethod parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and requires no parameter. Therefore, there 

is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and it returns a void. Therefore, there is no 

SS equivalent for this IS parameter. This suspend_connection method can raise 

OMG Notification Service (OMG TC Document telecom [2]) defined exception 

called ConnectionAl ready Inactive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : Mapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification 

Service (OMG TC Document telecom [2]) and requires no parameter. 

Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent 

method is resume_connection. This method is defined by OMG 

Notification Service (OMG TC Document telecom [2]) and returns a void. 

Therefore, there is no SS equivalent for this IS parameter. This 

resume_connection method can raise OMG Notification Service (OMG 

TC Document telecom [2]) defined exception called 

Connect ionAlreadyActive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotif icationCategories parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


notification 
CategoryList 


Return value of type 

NotificationlRPConstDefs : :Notif icationCategorySet 


M 


eventTypeList 


NotificationlRPConstDefs : : EventTypesSet 
event_type_list 





extendedEvent 
TypeList 


NotificationlRPConstDefs : : ExtendedEventTypesSet 
extended_event_type_list 





status 


GetNotif icationCategories, Ope rat ionNot Supported 


M 
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5.3 Notification parameter mapping 



Notification IRP: IS (3GPP TS 32.106-2 [5]) defines a generic notify and its parameters. This SS does not provide 
the mapping of these parameters to their CORBA SS equivalents. 

Other IRPs using the Notification IRP such as Alarm IRP: IS (3GPP TS 32.1 1 1-2 [6]) extend the generic notify for their 
specific use. Their corresponding SS documents shall define the mapping from their specific notification parameters 
(defined in their IS document) to their SS equivalents. These SS documents shall qualify their SS equivalents as well. 



5.4 Attribute mapping 



Notification IRP: IS (3GPP TS 32.106-2 [5]) defines the semantics of common attributes carried in notifications. This 
SS does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3GPP TS 32. 111-2 [6]) identify and qualify these common attributes for use in their environment. Their 
corresponding SS documents define the mapping of these attributes to their SS equivalents. 



6 Use of OIVIG Notification structuredEvent 

Notification IRP: IS (3GPP TS 32.106-2 [5]) defines attributes that are commonly present in notifications of all 
notification categories such as notifications emitted from Alarm IRP IRP Agent. 

In CORBA SS, OMG defined StructuredEvent (OMG TC Document telecom [2]) is used to carry nodfication. 
This clause identifies the OMG defined StructuredEvent attributes that carry the common attributes defined in 
3GPPTS 32.106-2 [5]. 

The composition of OMG StructuredEvent is: 

Header 

Fixed Header 

Domain_name 

TYpe_name 

Event_name 
Variabie Header 



Body 



Fiiterabie_body_f ields 
Remain ing_body 



Table 13 shows the OMG Structured Event attributes (middle column) that are used to carry the common notification 
attributes defined in Notification IRP: IS (3GPP TS 32.106-2 [5]). 



Common attributes 

defined in 

Notification IRP: IS 

(3GPPTS 32.106-2 

[5]) 



Attribute 

defined by 

OMG 

structured 
Event 



Table 13: Attributes of structuredEvent 
Comment 





There is no 
corresponding SS 
attribute. 



eventType 



domain_name It indicates that the StructuredEvent, carried in the Notification, is defined 
by a specific 3GPP IRP such as Alarm IRP, as opposed to OMG specified 
Telecommunication, healthcare, utility, finance, etc. It indicates the CORBA SS 
version number as well. 

It is a string. Legal values are defined in module. 

For Alarm IRP version 1:1, the value is ALARM_IRP_VERSI0N_1_1. 
type_name It indicates event types of this notification. The semantics of the event type is 
defined by ITU-T TMN Recommendations. Each IRP, such as Alarm IRP IS 
version 1, shall identify the ITU-T defined event types for their use. Each such 
IRP document shall define the values of the identified event Types as well. 
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extended 
EventType 



There is no 
corresponding SS 
attribute. 



event_name 



variable 
Header 



Dependent on the notification category, possible legal values are: 

COMMUNICATIONS_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
QUALITY_OF_SERVICE_ ALARM (clause 8.1.1 of ITU-T Recommendation X.736 
[8]), 

PROCESSING_ERROR_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
EQUIPMENT_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
ENVIRONMENT AL_ ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
PHYSICAL_VIOLATION (ITU-T Recommendation X.736 [1]), 
INTEGRITY_VIOLATION (ITU-T Recommendation X.736 [1]), 
SECURITY. VIOLATION (ITU-T Recommendation X.736 [1]), 
TIME_DOMAIN_VIOLATION (ITU-T Recommendation X.736 [1]), 
OPERATIONAL_VIOLATION (ITU-T Recommendation X.736 [1]). 

The bracketed number of each type indicates the reference where the semantics 
of the type is specified. 

It is a string. See each individual CORBA SS IDL module for each IRP using the 
Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of event type, the 
values specified by each IRP are only unique within one IRP. For uniqueness 
among all IRPs' specifications, the values of event type shall be coupled with the 
notification category, the value carried in domain_name of the same notification. 

The legal values carried in this attribute are specified by the IRP using the 
notification. For example. Alarm IRP: CORBA SS (3GPP TS 32.1 1 1-3 [7]) 
defines and uses the following values: 

NOTIFY_FM_NEW_ALARM, 
NOTIFY_FM_CHANGED_ALARM, 
NOTIFY_FM_ACK_STATE_CHANGED, 
NOTIFY_FM_CLEARED_ALARM and 
NOTIFY_FM_ALARM_LIST_REBUILT. 

It is a string. See each individual CORBA SS IDL module for each IRP using the 
Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of extended event 
type, the values specified by each IRP are only unique within one IRP. For 
uniqueness among all IRPs' specification, the values of extended event type shall 
be coupled with the notification category, the value carried in domain_name of 
the same notification. 



managed Object 
Class, managed 
Object 
Instance 



notification Id 



OneNV 
(name-value) 
pair of 

f ilterable_ 
body_f ields 

One NV pair 
of 

f ilterable_ 
body_f ields 



Name of NV pair is a string, NV_MANAGED_OBJECT_INSTANCE. 
Value of NV pair is a string. Syntax and semantics of this string conform to the 
Managed Object string representation specified in (3GPP TS 32.106-8 [4]). Note 
that two SS attributes are carried in this one NV pair since the string 
representation specified in 3GPP TS 32.106-8 [4] can convey the semantics of 
managedOb jectClass and managedOb jectlnstance in one string. 
Name of NV pair is a string, NV_NOTIFICATION_ID. 
Value of NV pair is a long. 



eventXime 



One NV pair 
of 

f ilterable_ 
body_f ields 



Name of NV pair is a string, NV_EVENT_TIME. 
Value of NV pair is an IRPTime. 



systemDN 



One NV pair Name of NV pair is a string, NV_SYSTEM_DN. 

of Value of NV pair is a string. Syntax and semantics of this string conforms to the 
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There is no 
corresponding SS 
attribute. 



f ilterable_ Managed Object string representation specified in 3GPP TS 32.106-8 [4]. 

body_f ields 

remaining_ 

Body 



7 IRPAgent's Behaviour 

This clause describes some IRPAgent's behaviour not captured by IDL. 

7.1 Subscription 

IRPManager can invoke multiple attach_push, multiple attach_push_b or multiple attach_pull using 
different manager_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to 
multiple "places" with their independent filter requirements. IRP Agent will not know if the notifications are going to 
the same IRPManager. 

If IRPManager invokes multiple attach_push, attach_push_b or attach_pull using the same 
manager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
AlreadySubscribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif icationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 

When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f liter, applicable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 

change_subscrlptlon_f liter; otherwise it shall get an exception. 

7.2 IRPAgent supports multiple categories of Notifications 

IRP Agent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 

IRPManager can query IRPAgent about the categories of notifications supported by using 

get_notlf lcatlon_categorles. 

IRPManager uses a parameter, notif lcatlon_categorles, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif lcatlon_categorles of attach_push, attach_push_b 
and attach_pull to specify that all IRPAgent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif lcatlon_categorles and if the operation is successful, 
IRPAgent shall reject subsequent attach_push operation, regardless if the notif lcatlon_categorles 
contains a zero-length sequence or one or more specific notification categories. IRPAgent shall have similar behaviour 
for attach_push_b and attach_pull. 
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7.3 IRPAgent's integrity risk of attach_push_b IVIethod 

In the case that IRP Agent implements this method by extending or using OMG compHant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRP Agent' s integrity. 

Given the object reference (lOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke SequenceProxyPushSupplier. MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 
consumerAdmin.MyChannel to get the lOR of the Notification Channel. IRPManager then can call 
eventChannel .MyFactory which will provide IRPManager the lOR of the EventChannelFactory itself 
IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 
which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 
channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRPAgent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

attach_push is mandatory. IRP Agent compliant to this IRP shall implement it. 

attach_push_b is optional. It is recommended that IRP Agent concerned with integrity risk should not implement 

the attach_push_b option. 



7.4 Quality of Service Parameters 



The OMG Notification Service [2] supports a variety of Quality of Service (QoS) properties, such as reliability and 
priority, that may be expressed to indicate the delivery characteristics of notifications. While many of these QoS 
parameters need to be based on Service Level Agreements, a number of them need to be specified as required. 
The following OMG Notification Service QoS parameter settings are required: 

1 . The order policy shall be set to FifoOrder (First-in, First-out) [2] . 

2. The message priority shall be set to 0, i.e., no priority [2]. 

3. The Start Time Supported shall be set to false, i.e., do not use Start Time [2]. 

4. The Stop Time Supported shall be set to false, i.e., do not use Stop Time [2]. 

When the OMG Notification Service is used, the IRP Agent has the responsibility of setting the OMG Notification 
Service Quality of Service parameters. 

When the OMG Notification Service is not used, the IRP Agent has the responsibility to provide First-in, First-out 
notification ordering and to not provide priority to one Event Type and/or Extended Event Type over others. 



8 Example of Notification related to alarm 

The following is an example of Notification related to alarm. 
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If type_name == NOTIFY_FM_NEW_ALARM, then the f ilterable_body_f ield attributes can contain: 

{ 

systemDN, "..."; 
alarmld, "abce232", 

notif icationid, 4467, 
managedOb jectlnstance, "...", 

eventTime, ..., 
probableCause, 3, 
perceivedSeverity, 2, 
specif icProblems, "xxx", 
additionalText , "...", 
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Annex A (normative): 
Notification IRP CORBA IDL 



/* ## Module: CommonlRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP. 

*/ 

#ifndef CommonlRPConstDef s_idl 
#define CommonlRPConstDef s_idl 
#include <TimeBase . idl> 
#pragma prefix "3gppsa5.org" 

module CommonlRPConstDef s { 

/* 

Definition imported from CosTime. The time refers to time in Greenwich 

Time Zone. It also consists of a time displacement factor in the form 

of minutes of displacement from the Greenwich Meridian. 

V 

typedef TimeBase : : UtcT IRPTime; 

enum Signal {OK, Failure, PartialFailure } ; 

typedef sequence <string> VersionNumberSet ; 

}; 

#endif 



/* ## Module: Notif icationlRPConstDef s 

This module contains definitions specific to Notification IRP. 

*/ 

#ifndef Notif IcationlRPConstDef s_idl 
♦define Notif icationlRPConstDef s_idl 
♦pragma prefix "3gppsa5.org" 

module Notif IcationlRPConstDef s { 

/* 

This is a string sequence identifying notification categories. 

A notification category is identified by the IRP name and its version. 

V 

typedef sequence <string> Notif icationCategorySet ; 

/* 

This is a sequence of strings identifying event types of a particular 

notification category. 

V 

typedef sequence <string> EventTypesPerNotif icationCategory; 

/* 

This sequence identifies all event types of all notification categories 
identified by Notif IcationCategorySet . The number of elements in this 
sequence shall be identical to that of Notif IcationCategorySet . 
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typedef sequence <EventTypesPerNotif icationCategory> EventTypesSet ; 

/* 

This is a sequence of strings identifying extended event types of 

a particular notification category. 

V 

typedef sequence <string> ExtendedEventTypePerNotif icationCategory ; 

/* 

This sequence identifies all extended event types of all notification 
categories identified by Notif icationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif IcationCategorySet . 
V 

typedef sequence <ExtendedEventTypePerNotif icationCategory> 
ExtendedEventTypesSet ; 

typedef sequence <long> Notif IDSetType; 

/* 

This holds identifiers of notifications that are correlated. 

V 

struct CorrelatedNotif ication { 

string source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI parameter-attribute 
// of the Structured Event, i.e., the notification. 
Notif IDSetType notiflDSet; 

}; 

Correlated Notification sets are sets of Correlated Notification 

structures . 

*/ 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSetType; 

/* 

This is a sequence of strings identifying Subscription Ids. 

V 

typedef string Subscriptionid; 

typedef sequence <SubscriptionId> SubscriptionldSet ; 

/* 

This block encapsulates valid strings carried in domain_name of 

structured event header. It carries the name of IRP and its 

corresponding CORBA SS version number. They are the returned 

values for get_XXX_IRP_version ( ) as well. 

V 

const string ALARM_IRP_VERSI0N_1_1 = "Ifl"; //alarm IRP 1:1 

const string C0NFIGURATI0N_IRP_VERSI0N_1_1 = "Icl"; //CM IRP 1:1 

/* 

This string is used as return value for get_notif ication_irp_version ( ) 

V 

const string N0TIFICATI0N_IRP_VERSI0N_1_1 = "Inl"; //Notification IRP 1:1 
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/* 

This block encapsulates string used in the name of the Name Value 

pair of the structured event. 

V 

const string NV_NOTIFICATION_ID = "a"; 

const string NV_CORRELATED_NOTIFICATIONS = "b"; 

const string NV_EVENT_TIME = "c"; 

const string NV_SYSTEM_DN = "d"; 

const string NV_MANAGED_OBJECT_CLASS = "e"; 

const string NV_MANAGED_OBJECT_INSTANCE = "f"; 



const string NV_PERCEIVED_SEVERITY = "h 
const string NV_SPECIFIC_PROBLEM 



n -; II 



II V " . 



const string NV_ALARM_ID = "k 

const string NV_ACK_USER_ID = "1"; 

const string NV_ACK_TIME = "m"; 

const string NV_ACK_SYSTEM_ID = "n" 

const string NV_ACK_STATE = "o"; 

const string NV_BACKED_UP_STATUS = 

const string NV_BACK_UP_OBJECT = "q 

const string NV_THRESHOLD_INFO = "r 

const string NV_TREND_INDICATION = 

const string NV_STATE_CHANGE_DEFINITION = "t 

const string NV_MONITORED_ATTRIBUTES = "u 

const string NV_PROPOSED_REPAIR_ACTIONS = "v 

const string NV_REASON = "w"; 



This indicates if the subscription is active (not suspended) or inactive. 

V 

enum SubscriptionState {Inactive, Active, DontKnow}; 



II Q II . 

^ r 

II ^ II , 

II n II • 



}; 

#endif 



/* ## Module: Notif icationlRPSystem 

This module implements capabilities of IRPAgent specified in Notification 
IRP : Information Service version 1 and its equivalents in Notification 
IRP: CORBA Solution Set version 1:1. 

*/ 

#if ndef Notif icat ion IRP System_idl 
#def ine Notif icat ionIRPSystem_idl 

# include "CosNotif yChannelAdmin . idl" 
♦include "Notif icationlRPConstDefs . idl" 
♦include "CommonlRPConstDef s . idl" 
♦pragma prefix "3gppsa5.org" 



module Notif icationlRPSystem { 

/* 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
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is outside the scope of this IRP. 
*/ 

exception Attach { string reason; }; 
exception DetachException { string reason; }; 

exception GetSubscriptionStatus { string reason; }; 
exception GetSubscriptionlds { string reason; }; 
exception ChangeSubscriptionFilter { string reason; }; 
exception GetNotif icationCategories { string reason; }; 
exception GetNotif icationlRPVersion { string reason; }; 

exception ParameterNotSupported { string parameter; }; 

// name of the unsupported parameter as defined in IDL 
exception InvalidParameter { string parameter; }; 

// name of the parameter as defined in IDL 
exception OperationNotSupported {}; 
exception AlreadySubscribed {}; 
exception AtLeastOneNotif icationCategoryNotSupported {}; 

interface Notif icationlRPOperations { 

/* ## Operation: attach_push 

V 

Notif icationlRPConstDef s :: Subscriptionid attach_push ( 

in string manager_ref erence, 

in long time_tick, 

in Notif icationlRPConstDef s : : Notif icationCategorySet 
notif ication_category_set, 

in string filter 
) 

raises (Attach, ParameterNotSupported, InvalidParameter, AlreadySubscribed, 
AtLeastOneNotif IcationCategoryNotSupported) ; 

/* ## Operation: attach_push_b 
V 

Notif icationlRPConstDef s :: Subscriptionid attach_push_b ( 
in string manager_ref erence, 
in long time_tick, 
in Notif IcationlRPConstDef s : : Notif IcationCategorySet 

notif ication_category_set, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises 
(Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, Already Subs 
cribed, AtLeastOneNotif IcationCategoryNotSupported) ; 

/* ## Operation: attach_pull 
V 
Notif icationlRPConstDef s :: Subscriptionid attach_pull ( 

in string manager_ref erence, 

in long time_tick, 

in Notif icationlRPConstDef s : : Notif icationCategorySet 
notif ication_category_set, 

in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, OperationNotSupported, ParameterNotSupported, 
InvalidParameter, AlreadySubscribed, 
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At Leas tOneNotificationCategoryNot Supported) ; 

/* ## Operation: detach 
V 
void detach ( 

in string manager_ref erence, 

in Notif icationlRPConstDef s : : Subscriptionid subscription_id 
) 
raises (DetachException, InvalidParameter) ; 

/* ## Operation: get_notif ication_IRP_version 

V 

CommonlRPConstDef s : : VersionNumberSet get_notif ication_IRP_version () 

raises (GetNotif icationlRPVersion) ; 



/* ## Operation: get_subscription_status 
V 
Notif icationlRPConstDef s : :Notif icationCategorySet get_subscription_status 

in Notif icationlRPConstDef s :: Subscriptionid subscription_id, 

out string f ilter_in_ef f ect , 

out Notif icationlRPConstDef s : : SubscriptionState subscription_state, 

out long time_tick 
) 
raises (GetSubscriptionStatus, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_subscription_ids 

V 

Notif IcationlRPConstDef s : : SubscriptionldSet get_subscription_ids ( 

in string manager_ref erence 
) 
raises (GetSubscriptionlds, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: change_subscription_f liter 
V 
void change_subscription_f liter ( 

in Notif IcationlRPConstDef s :: Subscriptionid subscription_id, 

in string filter 
) 
raises (ChangeSubscriptionFllter, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_notif ication_categories 
V 

Notif IcationlRPConstDef s : : Notif IcationCategorySet 
get_notif ication_categories ( 
out Notif IcationlRPConstDef s :: EventTypesSet event_type_list , 
out Notif IcationlRPConstDef s : : ExtendedEventTypesSet 
extended_event_type_list 
) 
raises (GetNotif icationCategories, OperationNotSupported) ; 



}; 

#endif 
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